home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 2010 April / PCWorld0410.iso / hity wydania / Ubuntu 9.10 PL / karmelkowy-koliberek-desktop-9.10-i386-PL.iso / casper / filesystem.squashfs / usr / share / doc / libtext-charwidth-perl / README < prev   
Encoding:
Text File  |  2003-06-25  |  2.1 KB  |  64 lines
  1. Text::CharWidth version 0.04
  2. ============================
  3.  
  4. This is a module to provide equivalent feature as wcwidth(3) and
  5. wcswidth(3).  This also provides mblen(3) equivalent subroutine.
  6.  
  7. mbwidth() and mbswidth() are provided subroutines corresponding
  8. wcwidth(3) and wcswidth(3) in C language.  The prefix "mb" expresses
  9. that they handles "multibyte character" in C meaning, i.e., character
  10. encoding specified by LC_CTYPE locale.
  11.  
  12. These subroutines are used to get the width of characters on terminal.
  13. Though most characters have width of 1, there are exceptions.
  14. Fullwidth characters are characters with width of 2.  Most of east
  15. Asian characters such as Hiragana, Katakana, Hangul, Han Ideogram
  16. are fullwidth.  Combining characters are characters with width of 0.
  17. Unicode has many combining characters like diacritical marks.  There
  18. are languages which need combining characters such as Thai and
  19. Vietnamese.
  20.  
  21. Thus, if you would like to format international texts on terminal,
  22. you will have to be aware of variation of character width and will
  23. want to use this module.
  24.  
  25. mblen() returns the number of bytes for the first character of
  26. the given string.  In 8bit character encodings, it is always 1.
  27. However, in multibyte encodings, this may be more than 1.
  28.  
  29. The parameter is given in locale encoding, not UTF-8 string.
  30. (Of course locale encoding is UTF-8 in UTF-8 locales.)
  31.  
  32.  
  33. Prerequisites
  34. -------------
  35.  
  36. This module requires your system to have wcwidth(), wcswidth(), and
  37. mblen() functions which are complian with the Single Unix Specification.
  38.  
  39.  
  40. Build and Install
  41. -----------------
  42.  
  43. Please use standard way to build and install this module:
  44.  
  45.    perl Makefile.PL
  46.    make
  47.    make install
  48.  
  49.  
  50. COPYRIGHT AND LICENCE
  51. ---------------------
  52.  
  53. Copyright (C) 2003 Tomohiro KUBOTA <kubota@debian.org>
  54.  
  55. This library is free software; you can redistribute it and/or modify
  56. it under the same terms of either:
  57.  
  58.     a) the GNU General Public License as published by the Free Software
  59.        Foundation; either version 1, or (at your option) any later
  60.        version, or
  61.  
  62.     b) the "Artistic License" which comes with Perl.
  63.  
  64.